home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr49 / 3d_lib.zip / READ.ME < prev    next >
Text File  |  1993-05-09  |  4KB  |  85 lines
  1.         3D Transforms Library - SHAREWARE
  2.  
  3.  
  4.                                    NOTICE
  5.  
  6.         3D TRANSFORMS is protected by copyright.  The functions in this
  7.         library may be used for your own personal use, but may NOT be
  8.         resold or used for any other commercial purpose, or included in
  9.         any commercial product without written permission from the author.
  10.         You may copy and distribute this product freely, provided 1) it
  11.         is reproduced in its entirety, including documentation and exam-
  12.         ples, and 2) you do not charge for copies (other than a nominal
  13.         copying fee to cover materials).
  14.  
  15.         You may obtain permission to use 3D TRANSFORMS commercially,
  16.         along with complete source code, by sending $25.00 U.S. to:
  17.  
  18.  
  19.  
  20. 3D       H      - Header file for using the 3DLIB
  21. READ     ME     - This file
  22. 3DLIB    DOC    - Documentation on using the library
  23. DEMO3D   PRJ    - Turbo C 2.0 ascii project file for demo program
  24. TC3D     BAT    - Build complete 3D libraries, all memory models
  25. TCMONE   BAT    -  The other batch files build one library
  26. TCONE    BAT    -   or incrementally update one. I got some errors
  27. TCONEM   BAT    -    with them, Use TC3D and build all, then use
  28.                 -     just the ones you need.
  29. DEMO3D   EXE    - Rotate 3 geometric objects, with hidden surface removal
  30. ZROT     C      - Rotation about Z axis
  31. AC       C      - Add corner to face on object
  32. YROT     C      - Rotation about Y axis
  33. XROT     C      - Rotation about X axis
  34. XF       C      - Transform object between coordinate systems
  35. VM       C      - Vector muiltiplication package
  36. TRANS    C      - Translation (move) object
  37. SCALE    C      - Scale (size) object
  38. PERSP    C      - Perspective transformation (draw objects with
  39.                 - perspective foreshortening, that is, draw with
  40.                 - a vanishing point)
  41. NORM     C      - Calculate normal to a face
  42. NO       C      - Create NEW object
  43. NF       C      - Create NEW face on current object
  44. MXZ      C      - Find maximum Z coordinate in face
  45. MNZ      C      - Find minimum Z coordinate in face
  46. MM       C      - Matrix multiplication package
  47. ID       C      - Create an identity matrix
  48. DUMPV    C      - Dump vertext to screen
  49. DUMPO    C      - Dump object to screen
  50. DUMPM    C      - Dump matrix to screen
  51. DUMPF    C      - Dump face to screen
  52. DP       C      - Calculate dot product
  53. DO       C      - Display object on screen
  54. DF       C      - Display face on screen
  55. DELF     C      - Delete face from object
  56. AF       C      - Add fact to object
  57. DEMO3D   C      - 3d Demo program
  58.  
  59. To build libraries:
  60.  
  61. Execute: TC3D, the batch file, with plenty of disk space and
  62. spare time.  Look at the comments in the batch file to see
  63. what assumptions it makes about where include and library
  64. files are.  Note that TLIB chokes out a lot of warnings as
  65. it builds the libraries. I'm not certain why, but the end
  66. result DOES WORK.  Also, when compiling, you will get more
  67. than a few warnings that "structures are passed by value".
  68. Turbo C can support this, but it is not normally done in C.
  69. A subroutine is generally passed a POINTER to a structure.
  70. You may wish to modify the associated .C functions,
  71. DEMO3D.C, and your own programs to use pointers
  72. instead...since they are more correct, and are generally
  73. preferred.
  74.  
  75. DEMO3D - This program assumes your vido adapter has multiple
  76. display pages.  This is true for EGA, but not VGA.  I
  77. modified the code so that if it detects VGA it "downshifts"
  78. to EGA.  I'm not certain how well it works in CGA or
  79. Hercules (if at all).  The program uses inactive display
  80. pages while it constructs the images - so you don't see them
  81. being painted - then makes the page active.  The animation
  82. is slow, but it's obvious the author did a GOOD JOB on this
  83. code overall.  For more details see 3dlib.doc!
  84.  
  85.